home *** CD-ROM | disk | FTP | other *** search
/ La Traviata / La Traviata.iso / viewer / scr2gif2.zip / SCR2GIF.DOC < prev    next >
Text File  |  1989-04-27  |  21KB  |  530 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                       Capture VGA and EGA screens to .GIF files
  12.                               Shareware Release Version 3.4
  13.                   Copyright (C) 1988,1989  Laurie and Bill Fleisher
  14.                                    4680 Carrick SE
  15.                                   Kentwood, MI 49508
  16.                                  (616)531-7007 Voice
  17.                                  (616)531-0821 Data 
  18.  
  19.  
  20.           This program consists of two modules.  The first on, SCRCAP, is a
  21.           TSR  (memory  resident program)  which  captures a  graphic color
  22.           screen  and  palette   to a   disk file.    The   second  module,
  23.           SCR2GIF.EXE,  converts this  file into a .GIF file, which  can be
  24.           displayed with   programs like  PICEM   or VGAGIF or  VPIC.   The
  25.           reason for the split modules  is  to keep the size of  the memory
  26.           resident program small.   This  prevents  competition for  memory
  27.           space with your   graphics editor  of display program.    Some of
  28.           these programs tend  to be   memory  hogs  when displaying Hi-Res
  29.           modes.    The SCRCAP  uses  only 3k of   memory. This should  not
  30.           interfere with memory usage very much.
  31.  
  32.           The conversion  program  will also  convert  uncompressed  screen
  33.           files generated by  COLORIX (a trademark of  RIX SOFTWORKS, Inc.)
  34.           to .GIF files, and also EGA Paint format files.
  35.  
  36.           To install the capture program, simply type SCRCAP. It will check
  37.           your video adapter, and  install itself if it finds  a compatible
  38.           adapter.   Otherwise it  simply aborts.   In order  to invoke it,
  39.           display the image  you want to capture.  Then press ALT and  C at
  40.           the same time.  After a few seconds of disk activity, a BEEP will
  41.           sound to indicate a successful capture.   SCRCAP will check video
  42.           modes to see if compatible mode is active.  If not,  it will exit
  43.           without capture with 3 beeps and will create a small binary file.
  44.            If this program's  beep sounds like a "fog horn"  in a valid VGA
  45.           or EGA 16  or 256 color   graphic screen  mode supported by  this
  46.           program ( please  check valid modes  below), please notify us  at
  47.           the above address or call  and we will try to help.
  48.  
  49.           There are now 3 types of beeps:
  50.                Successful Capture     - 1 high pitch beep
  51.                Unsupported mode       - 3 medium pitch beeps
  52.                Something didn't work  - 1 medium and 1 low pitch "FOG HORN"
  53.  
  54.           There is a switch to the capture program SCRCAP  which will allow
  55.           over ride of the default video board.  If you do not have a  STB,
  56.           Genoa or  Video 7  board,  the  program will  default to  a Genoa
  57.           board.  This may not be compatible  with other boards so a switch
  58.           can  be  used when  invoking the  SCRCAP  program.   Examples are
  59.           below.
  60.  
  61.  
  62.                                                                           1
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.                EXAMPLES:  for invoking the SCRCAP
  77.                1.   SCRCAP /0 - use Video 7 for capturing
  78.                2.   SCRCAP /1      - use Genoa for capturing
  79.                3.   SCRCAP /2      - use STB for capturing
  80.                4.   SCRCAP         - will check  your board for one  of the
  81.                                    above and if  not found will default  to
  82.                                    Orchid
  83.           Other switches for other boards include the following:
  84.                                 /3 - Orchid Designer
  85.                                 /4 - Standard VGA
  86.                                 /5 - Standard EGA   
  87.                                 /6 - Paradise Pro
  88.                                 /7 - ATI VGA Wonder
  89.           If  neither of  the  these configurations  work  with your  board
  90.           please contact us.
  91.  
  92.           If neither  of  the three  configurations  work with  your  board
  93.           please contact us.
  94.  
  95.           The file created will have a name of CAP-xxx.SCx, where xxx  is a
  96.           three digit decimal  number.  The  program checks the  directory,
  97.           and will use the lowest number not already in use.  You can write
  98.           999 files to a directory this way  (if you don't run out of  disk
  99.           space).   The  x that  is  the last  character  of the  extension
  100.           follows Colorix convention for file formats.
  101.  
  102.           If you  delete any .SCx files, SCRCAP  will fill the blank spaces
  103.           on the next capture before adding to the end of the list.
  104.  
  105.           Each file consists simply  of  a 768 byte area for 256  color and
  106.           48  bytes  for  the 16  color  which  containing  palette   data,
  107.           followed by  a screen   dump.   The total  size  is  dependent on
  108.           screen resolution.  For 16 color modes this is width divided by 8
  109.           multiplied by the height.  For 256 colors it  is width multiplied
  110.           by height.
  111.  
  112.           It is recommended you rename  the files to something  descriptive
  113.           when  you return  to DOS  unless you  are going  to  convert them
  114.           immediately.
  115.  
  116.           The SCR2GIF program is very simple to use.  There are three modes
  117.           for using it. The modes are determined by whether no, one, or two
  118.           file  names  are entered  on  the  command line  when  SCR2GIF is
  119.           invoked.
  120.  
  121.                     SCR2GIF        or
  122.                     SCR2GIF inputfilename       or
  123.                     SCR2GIF inputfilename outputfilename
  124.  
  125.  
  126.  
  127.  
  128.                                                                           2
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.            MODE 1
  143.  
  144.                     C:>SCR2GIF
  145.  
  146.           The first way of using it requires that you enter only SCR2GIF on
  147.           the command line.  It will  prompt for both  file names. It  will
  148.           fill in the suggested input file  extension of .SCR. You need not
  149.           enter  the extension if  .SCR is okay. Otherwise,  as soon as you
  150.           type the "." the SCR extension will  vanish so you can enter your
  151.           own extension. If it cannot find your input file name it will ask
  152.           you to reenter.
  153.  
  154.            The output file  name will  then be requested.  It will  present
  155.           your  input   file name with the extension   changed to "GIF". If
  156.           this is   okay,  just   hit the   ENTER   key. Otherwise,   start
  157.           entering the  filename you want. The  extension will behave as in
  158.           entering the  input file  name described  above.   If the  output
  159.           file  already  exists, it  will ask  permission to  overwrite it.
  160.            The  default   (ENTER) is "No, don't overwrite" It will then ask
  161.           for a new  file name.
  162.  
  163.            MODE 2
  164.  
  165.                     C:>SCR2GIF filename.SCR 
  166.                          or
  167.                     C:>SCR2GIF *.SCR
  168.  
  169.            This  mode will   accept wildcards. The   output file names will
  170.           be    the   same as  the   input  file names    except that   the
  171.           extension is  changed to .GIF.
  172.            It will accept   the same wildcards as DOS   (? or *). You  will
  173.           be   asked ONCE  whether it should  overwrite a .GIF  if the name
  174.           happens   to  be  the  same   as  the  output   file. This   will
  175.           apply  to   all    conversions if  a   wildcard  is used.     For
  176.           instance, if the   input  file  is  CAP-000.SCR and  it  finds  a
  177.           file   named CAP-000.GIF   it   will overwrite it   if you answer
  178.           Y. If, however, CAP-000.GIF   is  protected (Read  only attribute
  179.           set) it  will  refuse to  over-write  it and  "Permission denied"
  180.           will be displayed.
  181.  
  182.            MODE 3
  183.  
  184.                     C:>SCR2GIF inputname.SCR outputname.GIF
  185.  
  186.                     The  third  mode is   intended for  running  from batch
  187.           files and    accepts both  input  and output  file  names on  the
  188.           command line as:
  189.  
  190.            SCR2GIF myinput.scr myoutput.gif
  191.  
  192.  
  193.  
  194.                                                                           3
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.            An error   message is  generated if  it  cannot open the   input
  209.           file   (if it  can't find   it for   instance) or  if  it  cannot
  210.           open  the  output file (if the output file already exists).
  211.            In  any case,  the  program  will request whatever   information
  212.           it   requires.  If the output   file exists already, you will  be
  213.           asked  if you want to overwrite it.
  214.            In addition to  the above  modes, several switches  may be  used
  215.           which  will do the following:
  216.  
  217.  
  218.           /M  -  Invoke the EGA Palette MENU Editor
  219.           /D  -  Default ; Palette is in .SCR file
  220.           /S  -  Palette file same name as Input .SCR file;***
  221.           /   -  Palette file same name as Input .SCR file;***
  222.           /1  -  Palette file name is  "PALETTE1.PAL"***
  223.           /2  -  Palette file name is  "PALETTE2.PAL"***
  224.           /B  -  Palette file format is BINARY
  225.           /H  -  Default;  Palette file format is ASCII Hexadecimal
  226.           /P   -   Pause for  keypress after  a .SCR  file is  displayed on
  227.           screen
  228.           /C  -  NOT Available in this version
  229.                    Convert a 256 color to a 16 color
  230.           /?  -  This HELP output file
  231.           /V=#   Override VIDEO board Identification where #
  232.                                 0 - Vega 7 VGA
  233.                                 1 - Genoa 
  234.                                 2 - STB Systems 
  235.                                 3 - Orchid Designer   
  236.                                 4 - Standard VGA
  237.                                 5 - Standard EGA   
  238.                                 6 - Paradise Pro
  239.                                 7 - ATI VGA Wonder
  240.  
  241.             ***  Default format ASCII Hex
  242.  
  243.           Also included with this program are 2 sample substitute palettes,
  244.           PALETTE1.PAL  and PALETTE2.PAL.   The  first is  the standard  64
  245.           color EGA  palette.  The second is a  grey scale palette and will
  246.           only work on  a VGA graphic  board, although interesting  results
  247.           may occur if you try this on an EGA.
  248.             The substitute Palette files should have the following:
  249.  
  250.           ASCII HEX -
  251.                256 colors  - 768  ASCII Hex  numbers delimited  by <cr>  or
  252.                space  where each color is a  triplet of  red, Green  and   
  253.                                              Blue   values 0  to 63 for 256
  254.                                              colors.
  255.                16  colors - 195 + 16 ASCII Hex numbers delimited by <cr> or
  256.                space   where each color      is a triplet of Red, Green and
  257.                                              Blue  values 0  to  63 for  65
  258.                                              colors,   and   the   last  16
  259.  
  260.                                                                           4
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.                                              numbers  are  the  16  indexes
  274.                                              into the 64 color palette.
  275.           Binary    -  
  276.                256 colors  - 778  bytes  of data  where  the first  10  are
  277.                ignored 
  278.                16  colors - 195 + 16 + 10  bytes of data where the first 10
  279.                are ignored.   The binary files  allow the palette from  one
  280.                capture  to  be transported  into another  capture  file    
  281.                Note:   on EGA video  adapter boards the  palette may not be
  282.                the same as the displayed screen during a capture.
  283.  
  284.           EGA PALETTE MENU
  285.                     ->        move to next color
  286.                     <-        move to previous color
  287.                     Up Ar          add one to color at arrow
  288.                     Dn Ar          subtract one to color at arrow
  289.                     F1        Save changes and convert to .GIF
  290.                     F2        ReTry with previous palette
  291.                     F3        Shift all colors on palette right 4 
  292.                     F4        Save  changed palette  to a .PAL  (ASCII txt)
  293.                     file 
  294.                     ESC       Abort File conversion
  295.  
  296.           EXAMPLES:  
  297.  
  298.           1.    >SCR2GIF /M/P <return>
  299.  
  300.                This will prompt  you for an input and output  file, put the
  301.                screen  data  up and then go to  the EGA MENU Editor  if the
  302.                file is  16 colors.     Once you  have exited  the EGA  MENU
  303.                Editor the new  screen will  be  re-displayed  and then  the
  304.                program will pause waiting on a  keypress.  If you enter  an
  305.                ESCAPE  key  the program  will  abort  the conversion.    Be
  306.                forewarned that on a VGA graphics board with a palette other
  307.                than the standard 64 color palette,  the R G B keys may  not
  308.                have the same meaning as changing the colors of your picture
  309.                with respect to Red, Green and Blue.  
  310.  
  311.           2.    >SCR2GIF /1/B  *.SCR<return> 
  312.  
  313.                This will convert all files with the extension ".SCR", while
  314.                reading    the default palette in  file "PALETTE1.PAL" which
  315.                is a binary  formatted  with either  778 bytes or  221 bytes
  316.                depending on the number of colors    of the .SCR file. NOTE:
  317.                the .SCR files should all be the  same number   of colors.  
  318.  
  319.  
  320.           3.    >SCR2GIF /S CAP-000.SCR  NEWFILE.GIF<return>               
  321.  
  322.                This will  read in screen file "CAP-000.SCR" and the palette
  323.                file  "CAP-000.PAL"   The palette file  is expected in ASCII
  324.                Hex and  will be used  to convert    the screen file  to the
  325.  
  326.                                                                           5
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.                .GIF "NEWFILE.GIF"
  340.  
  341.           4.    >SCR2GIF<return>
  342.  
  343.                This  will  prompt  you for  an  input  and  output file  to
  344.                convert.  Since no switches are used the defaults will be:
  345.                     Palette used will be from the input file.
  346.                     No pausing after screen display
  347.                     Palette Menu Editor will Not be invoked.               
  348.                           
  349.  
  350.           The following modes have been tested on the STB systems, the Vega
  351.           Seven VGA,  and the  Genoa 5200 video boards
  352.  
  353.                 512 x 512, 16 colors    
  354.                 640 x 200, 16 colors
  355.           **    640 x 350, 16 colors   NOTE: some boards 640 x 400       
  356.                 640 x 480, 16 colors
  357.                 720 x 512, 16 colors   NOTE: some boards 720 x 540       
  358.                 800 x 600, 16 colors
  359.                1024 x 768, 16 colors  
  360.           **    320 x 200, 256 colors  
  361.                 512 x 512, 256 colors    
  362.                 640 x 350, 256 colors  NOTE: some boards 640 x 400       
  363.                 640 x 480, 256 colors
  364.                 720 x 512, 256 colors  NOTE: some boards 720 x 540       
  365.                 800 x 600, 256 colors
  366.  
  367.           ***  Note:  only these  modes  supported  by this  version.   The
  368.           licensed  version  supports  all  modes above.    To  receive the
  369.           licensed version, please send $19.95 to the address above,
  370.           Or call the data line with a VISA or MASTERCARD. 
  371.           Please also describe which Video adapter you have on your system.
  372.  
  373.            The    conversion   program  will   also    convert uncompressed
  374.           screen    files   generated  by  COLORIX  (a trademark    of  RIX
  375.           SOFTWORKS, Inc.)  to .GIF files. 
  376.  
  377.            DISCLAIMER: This   program is supplied  without warranty.    Use
  378.           at  your own risk.
  379.  
  380.            GIF is a trademark of H and R BLOCK Companies.
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.                                                                           6
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.           -----------------------------------------------------
  407.                                Revision Change History
  408.  
  409.           Version 2.4B changes:
  410.           1.   Fixes for  use with  the Vega  Seven VGA  board.   (Extended
  411.                modes not yet tested on a Video 7 board)
  412.           2.   Fixes for when  Menu editor is  used, palette was not  being
  413.                saved correctly in the .GIF file.
  414.  
  415.  
  416.  
  417.           Version 2.5B and 2.5
  418.           1.   Add enabling  Video 7 extensions  for extended modes  on the
  419.                Video 7 board.
  420.  
  421.  
  422.  
  423.           Version 2.6B and 2.6
  424.           1.   Bug fix  for Video  7 board.   Was  previously destroying  a
  425.                register before  switching pages  on extended  mode Video  7
  426.                board.
  427.  
  428.  
  429.           Version 3.0B  and 3.0
  430.  
  431.           1.   The  screen  capture  SCRCAP  will  now capture  in  COLORIX
  432.                format.  Colorix can read in the captured file.  Please note
  433.                that Colorix 16 color drivers for the VGA  have not yet been
  434.                completed by Colorix. (They said in  about 2-3 weeks).  Also
  435.                note  that it  does not capture  to EGApaint,  only Colorix.
  436.                They are different formats. The  GIF converter will, however
  437.                convert the  EGApaint 16  color files.  (as tested  from Bob
  438.                Montgomery's VPIC to RIX viewer)
  439.  
  440.           2.   The  screen capture board  default can be  overridden with a
  441.                switch at invoke time.  
  442.                     /0 - Video 7
  443.                     /1 - genoa
  444.                     /2 - STB
  445.  
  446.           3.   The palette  saved is only  48 bytes instead  of 768 for  16
  447.                color captures.   This means  the palettes on  16 color  VGA
  448.                images taking advantage of  the 16 of 64K color  palette can
  449.                not meaningfully change the palette using the MENU function.
  450.                However a straight capture to .GIF should maintain the 16 of
  451.                64K palette.
  452.  
  453.           4.   The program SCR2GIF was modified to read in the EGApaint and
  454.                Colorix 16 color format files and convert to .GIF.
  455.  
  456.  
  457.  
  458.                                                                           7
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.           5.   The  entire 16  color  capture file  is  manipulated in  ELM
  473.                memory  if available instead  of only 64k.   A temp  file is
  474.                created if ELM not available.
  475.  
  476.           6.   Fix problem  of confusion  about the  overwriting of  output
  477.                file on wild card conversions.
  478.  
  479.           Version 3.1B and 3.1
  480.           1.   If the  screen is scrolled using register writes  to 3D4 and
  481.                3D5 the screen  that is captured is what you see.  "What you
  482.                see  is  what  you  get".   (VPIC  scrolls  through register
  483.                writes.)
  484.           2.   Fix problem with EGAPaint not masking the most significant 2
  485.                bits. 
  486.  
  487.           Version 3.2
  488.  
  489.           1.   Add switches for Orchid, Paradise, and ATI VGA Wonder to the
  490.                SCRCAP  TSR program. A /#  on the command  line is the board
  491.                override.   Testing  was also  performed on  the Orchid  Pro
  492.                Designer Plus.
  493.           2.   Fix scroll  problem if scrolled  down past the  first memory
  494.                bank.
  495.           3.   Add switch overrides for the SCR2GIF  program.  A /V=# gives
  496.                the board override. 
  497.  
  498.           Version 3.3:
  499.  
  500.           1.   There are now 3 types of beeps:
  501.                Successful Capture     - 1 high pitch beep
  502.                Unsupported mode       - 3 medium pitch beeps
  503.                Something didn't work  - 1 medium and 1 low pitch "FOG HORN"
  504.  
  505.           2.   Bug fix for Video 7 - in determining mode.
  506.  
  507.           3.   Support for Colorix 1.1 16 color modes.  Will now capture to
  508.                format  and convert  Colorix new  16 color  screen files  to
  509.                .GIF.
  510.           4.   Add memory bank switching to support Paradise card.
  511.  
  512.  
  513.           Version 3.3-1
  514.           1. Bug fix for EGA using wild card mode.
  515.  
  516.  
  517.           Version 3.4
  518.           1.  Added ATI VGA Wonder support.
  519.  
  520.  
  521.  
  522.  
  523.  
  524.                                                                           8
  525.  
  526.  
  527.  
  528.  
  529.  
  530.